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Capturing error messages 



Effective system administration 
means that you have to keep 
the machines in your purview 
running at their best efficiency. 
Practically, this means that you 
must find out about error condi- 
tions whenever possible. You don't 
want the information to be lost in 
the weeds. To help you out, Solaris 
provides a system-logging facility 
to help you log error messages. 

Solaris' system-logging facility 
helps you manage log messages 
first by filtering the messages ac- 
cording to type, then formatting the 
messages into a consistent format: 



Jan 12 23:02:40 Devo unix: 
^fdc0 



fdO at 



Each line shows the date, hostname 
(Devo, in this case), the process that 
emitted the message, followed by 
the actual message body. 

In this article, we'll show you 
how to configure the system logger. 
Then, we'll show you how you can 
send messages to it in your pro- 
grams and script files. 

Types of system 
messages 

Solaris consists of several indepen- 
dent subsystems, each of which 
may emit logging information. If all 
the messages were mixed together. 



it could be more difficult than 
necessary to scan through your log 
files to detect and correct problems. 
For this reason, the system-logging 
facility groups messages by facility 
and severity. This helps you man- 
age the error messages, ignoring 
those that don't concern you. 

Coverage of subsystems is 
inconsistent. Some subsystems have 
specific facility codes, such as cron 
and mail. Other subsystems are 
grouped by class, such as daemon 
and user. Table A shows the facility 
codes currently in use by Solaris. 

The severity groupings, shown 
in Table B on page 2 in order of 

Table A: Solans facmty codes 



Facility 
code 


Generated by 


user 


User processes 


kern 


Solaris' kernel 


mail 


The mailing system 


daemon 


System daemons 


auth 


The authorization 
system 


Ipr 


Line printer 
spooling system 


news 


News servers 


cron 


The cron and at 
services scheduling 


localO— local7 


Reserved for 
site-specific uses 


mark 


Internal timestamp 
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highest to lowest priority, allow you to narrow your focus considerably. 
If you don't care about informational messages from the mail system, 
you're free to ignore them. 

TabiG B: severity codes in descending priority 



Severity code 


Generated because 


emerg 


Panic conditions may cause the system to shut down. I 


alert 


^ 

Situations occur that need immediate correction. J 


crit 


A critical error occurred. 


err 


A normal error occurred. 


warn 


A process is warning about a potentially serious j 
situation. 


notice 


A process noticed something important that's not 
an error. 


info 


Information about a process. 


debug 


Information useful to author /programmer of the 
subsystem. 



Configuring tlie system iogger 

Since you can select messages by their facility and severity, you can see 
exactly those messages you want. You can view some messages when 
they occur, save some in one or more files for viewing later, or send some 
to one or more operators. 

You can configure the system logger to do what you want by editing 
the /etc/syslog.conf iile. Each time the system logging daemon (sys logd) 
starts, it reads /etc/syslog.conf to find out how to treat any incoming 
messages. The file consists of records of the form 

selectoraction 

where selector specifies the list of error messages you want, and action 
tells s y s 1 0 g d what to do with them. 

The basic form of the selector field is: 

tacility. severity 

where the facility section is a comma-separated list of the facilities you 
want from the list in Table A, and sever i ty specifies the minimum 
severity level on which you want to take action. So if the se/ec for field 
happens to be 

mai I , news : err 

then sys logd will perform the specified action whenever either the mail 
or news subsystem submits a log message with emerg, alert, crit, and /or 
err severity levels. 

You can also connect multiple selector fields with a semicolon, so 
that you can perform the same action with multiple types of log mes- 
sages. If you want to perform the same action with critical kernel errors 
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as you do with the mail and news errors, you 
can use this selector field: 

mai l,news:err;l<ernel.crit 

The /etc/syslog.conf file offers a convenient 
shorthand: You can use an asterisk (*) as a 
faciUty name to specify all facilities except the 
mark facility. (This helps prevent the log file 
from growing too quickly.) 

The action field specifies where to send the 
message. You may specify a filename to store 
the message, the name of another computer, or 
a list of users to notify. If you want to specify a 
filename, it must start with a forward slash (/). 
Give the full path to the file where you want 
to store the messages. Store all mail and news 
errors in /etc/mail+news.errs with the line 

mai l,news:err /etc/mai l+news.errs 

If you want messages forwarded to another 
computer for storage, specify that computer by 
preceding the name with an at (@) symbol. To 
send all kernel messages to the host named 
sd_log, you can use the line 

kernel .debug ®sd_log 

If you want to specify one or more users, 
just list their names. To specify all users, use an 
asterisk (*). Please note that only users who are 
actually logged in will be notified. If you want 
everyone to be notified of a critical error, and 
the operator to be notified on any emergency 
messages and line printer notices, you could 
use these lines: 

I 

*.crit » 

# .emerg; Ipr. notice operator 

Whenever you change the configuration 
file, be sure to tell sys I ogd to reread it by 
sending it the HUP signal, like this: 

# ps -e I grep syslog | 

184 ? 0:01 syslogd i 

# ki II -HUP 184 ' 

Logging errors in your scripts 

Since a centralized facility exists to log error 
messages, you may as well use it for your own 
programs and scripts. This way, you can track 
the usage and any errors in your scripts and 
programs. For script files, it's very easy to use 
the system-logging facility — the logger com- 



mand sends a message to the logger for you 
with the following line: 

$ logger -p tacility. severity message 

Just replace tacility with the facility you 
want to log to and severity with the error level 
appropriate to the message. The remainder of 
the line contains the message to send to syslogd. 

Quick Tip: The localO through local7 facilities 
are reserved for site-specific uses, but there 
may not be enough facilities for all your pur- 
poses. In order to extend the range, you may 
want to group your programs into categories 
and put a prefix on each message body that 
specifies the actual script or program that gen- 
erated the message. 

For example, we might use localO for vari- 
ous disk-administration scripts, locall for user- 
administration scripts, etc. If the script named 
FindDtips detects an error, it might post a 
message like this one: 

logger -p localO. err FindDups: Can\'t allocate 
^space on /tmp 

If you're writing programs rather than 
scripts, you should read the man page (section 
3) for the openlog( ), syslog( ), close log( ), and 
setlogiiiask() functions. Briefly, you start using 
the logging service in your program with 

0 p e n 1 0 g ( ) , in which youtellitthe name of the 
process that's sending the message and the 
facility. You can also specify some options 
(described in /usr/include/sys/syslog.h) with the 
syntax 

void openlog(char *name, int options, int 
^faci lity) 

where name specifies the name of the process, 
options contains the list of options, and f a c i I - 

1 t y is the facility ID that you want to use in 
your program. 

When you actually want to write a message 
to the logging service, you use the s y s I o g ( ) 
function, where you specify the severity and 
the text string containing the log message. The 
syntax of the s y s I o g ( ) fxmction is as follows: 

void syslog(int severity, char *message) 

The set logmask( ) allows you to tell the 
logging facility which messages to process and 
which to discard. This is a great feature because 
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it allows you to log plenty of information when 
you're debugging a program. Then, when your 
program is working, you can deactivate some of 
your debugging messages without changing 
any code. Later, when you make improvements. 

Listing A: Log Demo, c 



I* LogDemo.c - System logging demo */ 
#include <stdio.h> 
#i nc lude <sys log . h> 
int main(int argc, char *argv[]) 
{ 

int iLogLevel=LOG_WARNING; 
char acBuf[200]; 

openlogC'LogDemo", LOG_PID, LOG_LOCAL0); 
if ( argc > 1 ) iLogLevel = atoi( argv[1]); 
set logmaski iLogLevel ); 

sys log( LOG_EMERG, "emergency" ); 
syslog(LOG_ALERT, "alert"); 
syslog(LOG_CRIT, "critical"); 
syslog(LOG_ERR, "error"); 
sys log(LOG_WARNING, "warning"); 
syslog(LOG_NOTICE, "notice"); 
syslog(LOG_INFO,"info"; 
sys log(LOG_DEBUG, "debug"); 

closelog(); 
return 0; 
1 



you can bring back the debugging messages — 
again without changing your program. The 
syntax for setlogmasKI ) is 

void set logmask( i nt severity) 

The s e 1 1 0 gma s k ( ) function lets you set the 
minimum level of messages you want your 
program to emit. If you want to see debugging 
messages, call setlogmask() with the severity of 
LOG_DEBUG. Later, when your program works 
and you only want to emit warnings and more 
severe messages, call it with LOG_WARNING. Please 
note that the values LOG_DEBUG, etc., are defined 
in the include file {/usr/include/sys/syslog.h). 

When your program is finished, you can 
close the logging service with a call to 
c i 0 s e 1 0 g ( ) . Listing A shows a simple C pro- 
gram that shows how you can use these func- 
tions in your programs. 

Conclusion 

Since Solaris provides a standard method for 
managing logging messages, you ought to 
become familiar with it. Not only do many of 
the programs you work with use the logging 
service, but you can also press it to your advan- 
tage in your own scripts and programs. ❖ 



QUICK TIP 




Taking advantage of the directory 
sort order 



By now, you've no doubt noticed that when 
you list a directory, I s arranges the names 
in a particular order. You can use I s to 
simplify managing file collections by using par- 
ticular prefixes or suffixes for filenames. 

The I s sorting method puts numerals be- 
fore uppercase letters, which appear before low- 
ercase. Various punctuation symbols are mixed 
throughout the list. (Since the sort order varies 
by locale, you might want to verify the sort or- 
der, or you can experiment with filenames and 
investigate on your own.) 

If you want to place a file near the begin- 
ning of a directory listing so that it will be no- 



ticed immediately, you may want to prefix it 
with a ! symbol. A file named '.README!, for 
example, will appear near the top of the list. 
We often use this trick in the /etc and /etc/rc?.d 
directories. We prefix a disabled script or con- 
figuration file with !DIS, so that such files will 
be grouped together at the front of the direc- 
tory listing. 

If you write programs that generate log 
files, you can name your log files starting with 
the date, such as 971225. logfile. This way, di- 
rectory listings will show your log files in 
chronological order. Alternatively, you can 
place the date at the end of your log file, so 



files will be grouped by the application that 
generated them. 

Don't forget that using a period (.) as a 
prefix normally makes the file invisible: It will 
appear in directory listings only when you 
use the -a option. This is a handy way to keep 
particular files out of the way, so they don't 
clutter your directory listings. Just take a look 
at Figure A — even though this is a small di- 
rectory, which one would you want to look 
through to find a file? 

There are many ways to take advantage 
of a sorted directory listing. Since I s goes to 
the trouble of sorting your directory listings 
for you, you may as well find ways to use it 
to make your life a little simpler! ❖ 



Figure A 



Taking advantage of the directoty soft order 



/export /home/marco 

> Is 

Down! oads 
So1'9S04 
Sol 9 805 

/expo rt /home /marco 

> Is -a 



, Xauthority 
. Xdef aul ts 
.ab_l ibrary 
,bash_hi story 
. bashrc 
. cetabl es 
.dt 

.dtprofile 

. dtsessioni ogf He 

/export /home/marco 



WORK 
autosave 
big_f il e_l ist 



f ind_uniq_f iles 
the .dt. action. 1 1st 
wabi 



. dtwmrc 
. emacs 
.1og1n.log 
.netscape 

. newsrc-news . win . net 

.old. bashrc 

. sh_hi story 

. sunsol verc 

.tt 

. wastebasket 
. xemacs-options 



Downl oads 
Sol 9804 
Sol 9 805 
WORK 

autosave 
big_f il e_l ist 
f ind_uniq_f il es 
the . dt . action . 1 ist 
wabi 



Name little-used files and directories with a period (.) prefix to minimize 
clutter in your directory listings. 



FILE MANAGEMENT 




Splitting large files for distribution 



If some of your offices aren't cormected to 
the Internet, you probably know what a 
hassle it is to send files from one location to 
another on floppies. But what happens when your 
files become too large to fit on a floppy disk? 

One option is to use a magnetic tape similar 
to those you use for backing up your system. 
However, tapes can be expensive (which is 
especially bad if the other office delays return- 
ing them). Also, this option mandates that all 
the sites where you distribute files must have 
the same type of tape drive available. 

On the other hand, maybe the other office is 
on the Internet, but the mailer is set to pass only 
text files of a particular size or smaller. In this 
case, you must be sure that your file is in ASCII 
format and that it meets the size requirements. 

In either case, it would be nice to be able to 
break up your file into multiple chunks. Well, 
Solaris provides a command that's ideal for this 
purpose — the split command. This command 
can break up files into whatever size you select 
and will sequentially name the resulting files so 
that you can conveniently reassemble them. 

Convert files to ASCII and 
split them 

The split command will break your files into 
chtmks based on the number of lines or on the 



particular size you select. If you'd like to s p 1 i t 
a file into chunks 5,000 lines long, you'd use 
this form of the command: 

$ split -5000 BigFi le 

The -5000 parameter tells sp I i t to break 
the file into 5,000 line chunks. However, you 
can specify fixed-size pieces like this: 

$ split -b lOk BigFi le 

Here, we told s p I i t to break the file into 
10KB pieces with the -b 10k switch. If you use 
m instead of k, you specify megabytes; if you 
use neither, the result will indicate the chimk 
size in bytes. If you don't specify the chunk size 
with either method, then split defaults to a 
chunk size of 1,000 lines. 

Quick Tip: You'll want to keep in mind that a 
line count really has meaning only for a text 
file. In a binary file, a line may be arbitrarily 
long, because the newline characters may ap- 
pear anywhere in the binary file — if they appear 
at all! If you're going to split a binary file, you 
should use the -b method. 

If you need the file in ASCII form, though, 
you'll want to use uuencodeto change your file 
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into ASCII characters; then you can split the 
file. In this case, you can use the line-count 
method. You can uuencodea file like this: 

J uuencode InFile DestFile >OutFile 

InFile specifies the name of the file that you 
want to convert to ASCII, DestFile specifies the 
name you want the file to be called on the remote 
system, and OiitFile is the name you want to call 
the ASCII file on your own system. To reverse 
the process, use uudecodeto convert the ASCII 
file back to binary, with the line 

$ uudecode Fi leNaroe 

Splitting your fiies for 
f ioppy drives 

If you're using a 1.44MB floppy disk drive, 
you'll want to split your files into 1.4MB 
chunks. Suppose that you want to send the file 
BigFile to one of your sites, but it's too large (at 
about 4MB) to fit on a floppy. You can split the 
file with the command: 

$ split -b 1400k BigFile 

$ Is -Is 

total 159G8 

7968 BigFi le 

2816 xaa 

2816 xab 

2368 xac 

Since we didn't specify a base name, the 
split command just uses x, then it adds the 
sequence ID (aa, ab, ac, etc.) to each chunk that's 



been split off until it reaches the end of the file. 
If you don't like to use x as the base filename, 
you can specify anything you want by adding 
it to the end of the command line, using the 
following code: 

$ split -b 1400k BigFile Bi gFi le_chunk . 

$ Is -Is 

total 15968 

7968 BigFi le 

2816 BigFi le_chunk.aa 

2816 BigFi le_chunk.ab 

2368 BigFi le_chunk.ac 

Now you can copy the smaller files to floppy 
disks and send them to the other offices. 

Reassembling tlie file 

Once the recipient gets the files, it's a simple 
matter to reassemble them for use. Simply use 
the cat command to combine them, like this: 

$ cat BigFi le_chunk.aa Bi gFi le_chunk . ab 
Bi gFi le_chunk. ac >Bi gFi le 

This ca t command sends the output of 
each chunk, in the specified order, to Bi gFi le. 
However, you needn't type all the filenames: 
When you use wild cards, your shell automati- 
cally sorts the matching names. Since you want 
all the chunks to be assembled in the same 
order, you can just use this command: 

$ cat BigFi le_chunk.* >BigFile 

This method is a lot simpler, especially when 
you're contending with multiple chunks. ❖ 



BEGINNER'S TIP 




Using the su command for quick 
problem diagnosis 



Has this ever happened to you? You're on 
your way to troubleshoot a problem on a 
machine in the network you administer. 
As you approach the problem computer, half a 
dozen people stop you with questions about 
their own systems. Before you know it, you've 
spent two hours trying to fix a problem that 
should have taken 10 minutes. 



Fortunately, Solaris offers a solution that 
allows you to attend to the needs of your users 
without exposing yourself to the dangers of 
hallway questioners. In many instances, you 
can fix client machines by remote control. In 
this article, we'll show you a way to diagnose 
and correct problems in client machines from 
the security and anonymity of your office. 



Rise and shine 

It's much easier to schedule time and stick to 
your priorities if you can solve problems from 
your own desk. First, you might try to r I og i n to 
the user's machine to see if you can see the 
problem. Since many problems are centered 
around file permissions, you may have to log 
into the specific account to see the problem: 

/root> rlogin pinky -I user 
Password: 

Uh-oh! You don't knov^ the user's pass- 
word, and you shouldn't ask for it, as it could 
compromise security. What should you do? 

Bypassing passwords 

One way you can avoid the necessity for using 
a password is to either change or remove the 
password altogether. However, when you're 
finished with your task, the user must then se- 
lect a new password for the account, so remov- 
ing the password isn't the easiest solution. 

Fortunately, as a system administrator, you 
don't need others' passwords to log on to the 
system. First, go ahead and rlogin into the ma- 
chine as yourself. As you may know, if you 
then su to the user's account, su will ask for a 
password, as follows: 

/root> rlogin pinky -I user 
Password: 

Last login: Mon Jan 5 11:06:06 from Zappa 
bash$ su user 
Password : 

As a matter of fact, you can easily get into 
the user's account without bothering with a pass- 
word by using s u from the root account to any 
other account. So, su to the root account, then su 



to the user's account with these lines of code: 

bashS su roof 
Password : 

# su user 
# 

If the user's problem deals only with per- 
missions, you may be able to reproduce the 
problem and find the solution. However, you 
might be unable to reproduce the problem be- 
cause you haven't run the program as the other 
user did. The missing piece of the puzzle is the 
state of the environment variables, such as PATH. 

Tiie su command's -i option 

You can avoid this headache by adding the - 1 
option to the su command. The - 1 option tells 
the su command to act as if you were the speci- 
fied user just logging into the system. In this 
case, su starts a new login shell for the user's 
account. The new shell then runs the shell 
startup scripts, configures the environment 
variables, etc., just as though you were the 
specified user. As a result, when you try to re- 
produce a problem reported by a user, you'll 
have a much simpler time doing so. 

bash$ su root 
Password: 

# su user 
Hello user! 
Devo:"> 

Conclusion 

Administering a network can be difficult 
enough without having to run around the 
building solving various and sundry user prob- 
lems. By using r I og i n in conjunction with the 
s u - 1 command, you should be able to rectify 
many problems without leaving your office. ❖ 



PPP PERFORMANCE TIP 




Speeding up your PPP link 



If you're using Solaris' PPP facility, you can 
probably squeeze a little extra performance 
out of the link. By properly setting the 
ipcp_async_map for your commimications paths, 
you can transmit the same amount of informa- 
tion over the network in fewer bytes, thereby 
shaving some time off your file transfers. 



So what is ipcp_async_map? 

The PPP configuration file {/etc/asppp.cf) allows 
you to specify the characteristics for each 
communications pathway you'll use for PPP. 
One of the parameters you can specify is the 
obscure ipcp_async_map. Reading the man page 
for aspppd doesn't shed much light on the 
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purpose of this parameter, as you can see in 
Figure A. After some digging, we discovered 
what this option means. 

Figure A 

i pcp_async_map hex-number 

Specifies the async control character map 
for the current path. The hex-number is 
the natural (i.e., big endian) form repre- 
sentation of the four octets that comprise 
the map. The default value is ffffffff. 

This excerpt from aspppd's man page doesn't really tell us 
how and when to use the ipcp_async_map option. 

First, let's look at some background infor- 
mation. As you know, a byte can hold 256 
values. You probably also know that the first 32 
bytes are often used to represent control charac- 
ters in the ASCII character set, e.g., backspace, 
carriage return, escape, newline, and tab. 

It turns out that the 32-bit number set by 
ipcp_async_map tells the PPP link which control 
characters to treat specially. If a bit is on, then 
PPP must treat the corresponding control 
character in a special way — where the lowest 
order bit maps to the next bit maps to ^A, 
then ^B, etc. Since the default value is Oxffffffff 
(i.e., all bits are on), all the control characters 
receive special treatment. 

Just what special treatment does the PPP 
link give to a control character? When PPP is 
told to treat a control character specially, it 
doesn't send that character at all. Instead, PPP 
sends a two-byte sequence that represents the 
character. So, if you're sending a file where all 
byte values are equally distributed, then you'll 
send about 12 percent more data than you 
want. (32 possible byte values are sent as pairs 
of bytes, rather than single bytes.) 

Why give a character special 
treatment? 

Ideally, you wouldn't treat the control characters 
in a special way. In a perfect communications 
path, equipment would simply pass all bytes 
straight through to their destination. However, 
you must take care with control characters 
because some equipment in a communications 
path between the client and host computer may 
perform one or more special actions on receipt 
of particular control characters. 

Unfortunately, we live in a less-than-perfect 
world. Some terminal controllers, when they 
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receive a ^O, will flush the data in the buffer. If 
you use a modem with a cheap cable and are 
forced to use software handshaking, then you'll 
use ^S and '^Q to stop and restart communica- 
tions. (You'd save yourself untold headaches by 
turning off software handshaking and using a 
good cable with your modem instead.) 



Tallle A: control characters 



Hex 




ASCII 




Code 


Symbol 


Name 


Description 


nn 




NUL 


Ui 


A A 




Start of header 


uz 


AR 
D 




otart text 


Uo 


Al^ 


ETX 


End text 


04 




EOT 


End of transmission 


05 




ENQ 


Enquire 


06 


Ap 


ACK 


Acknowledge 


07 




BEL 


Bell 


08 




BS 


Backspace 


09 


^I 


HT 


Tab 


Oa 




LF 


Linefeed (\n) 


Ob 




VT 


Vertical tab 


Oc 




FF 


Formfeed 


Od 




CR 


Carriage return (\r) 


Oe 


AN 


SO 


Shift out 


Of 




SI 


Shift in 


10 


Ap 


DLE 


Data link escape 


11 




DCl 


Device control 1 








(XON, resume xmit) 


12 






Device control 2 




AC 


DC3 


Device control 3 








(XOFF, pause xmit) 


14 


AJ 


DC4 


Device control 1 


15 


-^U 


NAK 


Negative acknowledge 


16 


AV 


SYN 


Synchronous idle 


17 


AW 


ETB 


End transmission block 


18 


-^X 


CAN 


Cancel 


19 


AY 


EM 


End of medium 


la 




SUB 


Substitute 


lb 


^[ 


ESC 


Escape 


Ic 




FS 


File separator 


Id 


^] 


GS 


Group separator 


le 


AA 


RS 


Record separator 


If 


A 


US 


Unit separator 



Setting ipcp_async_map 

If you're using a perfect commuriications 
pathway, then you can set ipcp_async_map to 0 
so none of the control characters receive special 
treatment. This can shave more than 10 percent 
off your file transfer times on your PPP link. 
(You probably won't attain that result, since 
other sources of commimications delays will 
also affect your communications.) 

If you know which control characters are 
treated specially in your communications path, 
you can still save some time on your transfers 
by telling the PPP facility to treat only those 
characters specially. Let's suppose that you're 
using software handshaking (i.e., and '^Q 
are special) on your modem, and your ISP is 
using a terminal controller in which flushes 
the buffer. Now we just find out which bits 
correspond to ^O, ^Q, and and set only 
those bits. Table A provides a list of all the 
control characters. 

At this point, all we need to do is build a 
hex number with bits OxOf, 0x11, and 0x13 on, 
and the rest off. Since the bits are numbered 
from right to left, we come up with a binary 
number, which we then convert to hex. To 
make the process simpler to see, the first line 
shows the control character symbol, and the 
next line shows the binary number we made by 
setting ^O, ^Q, and '^S to one, and setting the 
rest to zero. The third line shows the hexadeci- 
mal representation of the number. 

_"]\ [ZYX WVUT SRQP ONML KJIH GFED CBAs> 
0000 0000 0000 1010 1000 0000 0000 0000 
00OA80OO 

We arranged the number in groups of four 
bits since it simplifies converting from binary to 
hexadecimal. To convert back and forth, use 
Table B. Now we can edit the appropriate path 
block in/efc/asppp.c/to set the ipcp_async_map 
option to our newly computed value, as shown 
in Figure B. 

Don't hit tiie liooiis quite yet... 

Since Sun has no idea what communications 
equipment lies between your host and your 
ISP's host, it sets ipcp_async_map to a conserva- 
tive value that won't fail. While this saves Sun a 
lot of service calls, this preset value costs us 
time each time we transfer binary files over our 
PPP link. 



Table B: Converting back and forth from binary to 
tiexadecimal 



Hex 


Binary 


0 


0000 


1 


0001 


2 


0010 


3 


0011 


4 


0100 


5 


0101 


6 


0110 


7 


0111 



Hex 


Binary 


8 


1000 


9 


1001 


A 


1010 


B 


1011 


C 


1100 


D 


1101 


E 


1110 


F 


1111 



Figure B 



Speeding up youi PPP liiiL 



# /etc/asppp.cf - 


- DiaTup PPP 1 ink 


configuration 


##### 






# Dial out to WinNET 




##### 






ifconfig ipdptpO 


plumb 19 8.70.1 47 


210 up metric 1 


path 








jn interface IpdptpO # He connect via /dev/lpdptpO 

J I peer_system_name WinNET # /etc/uucp/Systems record key 

I ipcp_async_map aSOOO # Escape '0^ "Qj and «S 

We modified tfiis patti biocl< to specify an ipcp_async_map value ofaSOOO. 



If your setup is relatively standard, then 
you shouldn't need special treatment on any 
control characters. So, before digging out all the 
manuals on your equipment, go ahead and try 
0, and send a binary file or two over your PPP 
link. Be sure that your test file has every 
possible character in it. If you can successfully 
transmit this file, then you're finished. 

If your file fails to transmit, then hit the 
books. You can read the manuals to ascertion 
which control characters must be treated 
specially, or you can figure it out by trial and 
error. 

Conciusion 

Since the default value of ipcp_async_map is so 
conservative, there's an opportunity for you to 
improve the performance of your PPP link 
when you transmit binary files. Text files tend 
to use few control characters, and those (tab, 
carriage return, newline, formfeed, tab) are so 
commonly-used in text that communications 
equipment shouldn't require any special 
handling for them. Thus, you can achieve a 
modest performance gain by turning off just 
those control characters. ❖ 
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DEBUGGING TRICK 



Monitoring an active iog fiie 




any programs write log files to assist 
with the debugging process. So, when 
you're installing a system, you run it 



and examine the log files to try to find out what 
went wrong. Did you know that you can examine 
the contents of a logging file, even while it's in 
use? What's more, you can feed those contents 
to another program for processing. 

What's the secret? 

As long as you have read permissions on a file, 
you can read a file that's still open for writing 
by another process. Since many programs write 
data to log files, you needn't wait for the program 
to finish rurming before you start reading it. 
However, once the program that's reading the 
file encounters the end of the file, it will then 
terminate — unless it's specially written. 

It turns out, though, that you needn't write 
your own special program. Solaris provides an 
option (-f ) on the tail command that will, 
when it reaches the end of the file, wait a little 
while, then look for more input. The tail 
command will stay in this loop imtil you 
explicitly terminate it. 

As an example, when we were working on 
the PPP article, we needed to watch /etc/log/ 
asppp.log to find out the source of dialing 
problems, IP negotiation, etc. To do so, we used 
the simple command 

# tai I -f /etc/ log/asppp . log 

This way, we could see the logging information 
as it's written. 

Processing the log 

You can use this trick to allow other programs 
to work on the log file, too. Since the tail program 
prints its output on the standard output, you 
can use it to start a command pipeline. For 
example, when we were looking over the IP 
negotiation phase, we didn't want to look at all 
the other messages. So we used the command 

# tail -f /etc/log/asppp. log I grep IP_NCP 

Since we chose this method, grep could throw 
away all messages that didn't involve the 
IP_NCP (IP negotiation) protocol. 



IVIonitoring multiple streams 

Have you ever wanted to watch both the 
standard output and standard error streams at 
the same time? If so, you probably resorted to 
something like the line 

# your_program 2>&1 

which tells the Korn or Bourne shell to send the 
standard error stream (2) to the same place as 
the standard output stream (1). 

However, since this mixes the streams, the 
output can get confused. If you would like to 
see both streams separately in different windows, 
then in one window, you can run your program 
piping the error stream to a file with this line: 

# your_program 2>std.err.out 

In another window, you can view the error 
stream using the following tail - f command: 

# tai I -f std.err.out 

Conclusion 

The next time you're installing a program that 
generates log files, try the trick we just de- 
scribed. Real-time feedback can be a big help in 
debugging, because you can see what's happen- 
ing on your system at the time the log message 
is generated. The ability to then pipe the results 
through other programs for processing is just 
the icing on the cake! ❖ 

Are you a good tipper? 

Do you have any great Solaris tips that j 

you've discovered? If so, send them 1 

our way! If we use your tip, it will appear < 

on our weekly online ZDTips service. (Visit ! 

www.zdtips.com to check out all our avail- i 

able tip services.) We may also publish it here : 
in Inside Solaris. Your byline will appear 
with the tip, along with your E-mail and /or 

Web addresses. J 

Send your tips to inside_solaris@zd.com, l 

fax them to "Solaris tips" at (502) 491-4200, \ 

or mail them to j 

Inside Solaris ; 
The Cobb Group 

9420 Bunsen Parkway Suite 300 \ 

Louisville, KY 40220 ^ 



SERIAL COMMUNICATIONS 



pial-on-demand connections with aspppd 

Basic PPP configuration review 



Internet connectivity seems to become more 
important each day, with most companies 
requiring a presence on the Internet. Small 
companies may choose to have an Internet 
Service Provider (ISP) host a Web site for them 
so they can transact business over the Web. 
Large companies might use leased lines to 
supply a high-speed, full-time connection to the 
Internet. And of course, there's the large gray 
area between having no connection and main- 
taining a full-time connection. 

Your company may need to establish a 
connection to the Internet. Perhaps you must 
upgrade your E-mail services so that you get 
frequent mail delivery. Or maybe the vice 
president wishes to browse the Web in order 
to check on stock prices during lunch. 

Using a full-time cormection via a leased line 
is expensive. However, you can get high-speed 
access at any time, day or night. You'll have to 
pay for the leased line, the equipment you'll use 
on your premises, and (via the setup and monthly 
charges) the equipment on your ISP's site. 

Part-time connectivity 

For many smaller companies, there just isn't 
enough benefit to justify the expense of a leased 
line and the requisite extra equipment. In such 
cases, you must find lower-cost alternatives. 
One alternative is to use a standard modem to 
connect to your ISP only during certain times 
of the day. This way, you can use a standard 
telephone line and basic modem, which is a 
cost-effective solution. This solution is espe- 
cially tempting, since every copy of Solaris 
ships with a dialup PPP facility built-in. 

In this article, we're going to show you two 
methods in which you can use the dialup PPP 
facility for a part-time connection. The first 
method uses a static IP address with automatic 
dial-on-demand, and the second uses a dy- 
namic IP address with manual connect and 
discormect. 

However, both methods are based on the 
standard PPP installation, so before we show 
you how to create a part-time connection, let's 
briefly review basic PPP setup for dial-out 
cormections. (Since we covered this in the 
article "Configuring A Remote PPP Dial-Up 
Client For Solaris 2.X" in our February 1996 
issue, we'll skip over some of the details.) 



First, you must ensure that you have all the 
required packages, which are listed in Figure 
A, installed on your machine. Please note that 
the uucp packages (SUNWbnur, SUNWhnuu) 
are required because the PPP connection is 
established with the standard uucp dialer 
services. The first line of Figure A shows the 
command you use to determine whether the 
required packages are installed. If they're 
not, you'll need to install them from your 
distribution CD. 

Figure A 



# pkginfo I egrep ppplbnu"' 

system SUNWapppr PPP/IP Asynchronous PPP daemon configuration 

system SUNHapppu PPP/IP Asynchronous PPP daemon and PPP login 

system SUNHbnur Networking UUCP Utilities, (Root) 

system SUNWbnuu Networking UUCP Utilities, (Usr) 

system SUNHpppk PPP/IP and IPdialup Device Drivers 



files 
service 



The PPP package requires these five pacl<ages. 

Once you have these packages installed, 
you must configure your serial port and 
modem to communicate properly with one 
another. If you use an external modem, be sure 
you use a quality cable, because some cheap 
cables omit some of the modem signals, 
making it difficult to maintain a good connec- 
tion. (This topic is complex enough to warrant 
its own article, so if you have any difficulty 
configuring your serial ports or modem, then 
read Stokely Consulting's excellent Web page 
on the subject "Celeste's Tutorial on Solaris 2.x 
Modems and Terminals," which you'll find at 
www.stokely.com.) 



Quick Tip: We advise you to use an exter- 
nal modem, so you'll be able to reset it 
easily by turning it off and on. While you 
learn about serial ports, it's possible to get 
the modem stuck in a state from which it's 
difficult to recover. Internal modems, 
while cheaper, are more difficult to reset 
since you must turn off your computer. To 
do so until you gain enough experience 
with serial port and modem configuration, 
you should use an external modem. 
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Figure B 



Now we're ready to configure the files. For 
the basic PPP configuration, we need to config- 
ure only three files. The file /etc/asppp.c/ config- 
ures the PPP configuration; /etc/uiicp/Systems 
configures the chat script for dialing the mo- 
dem; and /etc /uucp /Devices configures the mo- 
dem you'll use to connect to the modem. You'll 
also want to configure /etc/gateways to prevent 
routing information from consuming band- 
width on your PPP link. 

Configuring /etc/asppp.cf 

Figure B shows a typical /etc/asppp.cf i\\e that 
we're using to cormect to our ISP. The line 
starting with i f conf i g specifies how to set up 
the interface. Specifically, we're telling i f coni i g 
to set up device ipdptpO (the dialup link) using 
PPP address 198.70.147.210, that the link is up 
(i.e., it's enabled), and that it's a connection to a 
remote machine. 

The next line tells the PPP facility that we're 
starting a new path (communications path). First, 
we specify that this path is tied to the interface 
ipdptpO. (You must specify the interface name 
because the PPP facility supports multiple 
incoming and outgoing paths — this way you 
can tie the path to the right i f conf i g statement.) 
Then, we specify the name of the record in the / 
etc/uucp/Systems file that we use to log into our 
ISP. Since we use WinNET for our ISP, we'll call 
the record WinNET. 

When you create the 1 f c 0 n f i g conimand, 
you must select an IP address to tie the inter- 
face. If you're using a static IP address, you'll 
need to specify the address your ISP gives you. 
If you're using a dynamic IP address, you can 
use any value (other than 0.0.0.0) because, 
during login, it will change to the value that the 
ISP gives it for that login. 

Configuring /etc/uucp/Systems 

Nov/, let's add the WinNET record to our /etc 
/uucp /Systems file. To do so, we simply add the 



Dial-on- deni.^ncl connocttons witli aspppd 



# /etc/asppp.cf - Dialup PPP link coni-iguration 
##### 

# Dialout to HinNET 
##### 

ifconfig ipdptpO plumb 198.70,147,210 up metric 1 

path 

interface 
peer_system_name 



ipdptpO 
HinNET 



# He connect via /dev/ipdptpO 

# /etc/uucp/Systems record key 



The basic configuration tias no fhlis, but it wili get the job done. 



following line to the end of the file. You'll have to 
change this record because the sequence of opera- 
tions used to log into your ISP will be different 
from ours. At the very least, you must change 
telephone, user name, and password to reflect 
those that you use with your ISP with the line 

WinNET Any ACU 38400 telephone "" P_ZERO 
"" \r\n gin: username ord: password 

Please note that the previous code is all one line. 
The first word, WinNET, is the record name. 
Any refers to the day and time the record may 
be used, meaning any day or time. The follow- 
ing field is the device type, where ACU speci- 
fies an Automatic Call Unit, which is what you'll 
probably need. You can refer to the file /etc/ 
uiicp/Devices for information about other device 
types that are available. Next comes the baud 
rate you want to use for the cormection fol- 
lowed by the telephone number to call. 

The rest of the line is the uucp chat script 
that logs you into the ISP. The basic structure of 
the chat script is a set of expect/send pairs. First 
you specify what you're expecting to read from 
the modem. Once it's read, the script sends the 
send value. The process repeats until it reaches 
the end of the last pair. If the modem is still 
cormected at the end of this sequence, then the 
hosts are connected. (Please note that the PPP 
layer hasn't yet been established.) 

We're expecting an empty string ("") from 
the modem, which means that it will immedi- 
ately send the next part, P__ZERO, to the serial 
port. This is actually a special value that tells 
uucp to program the serial port to use eight data 
bits with no parity, which is the setup required 
to get a PPP link working. (Similarly, P_ONE 
sets parity to one, P_EVEN sets even parity, and 
P_ODD sets odd parity) 

Now we try to log into our ISP. To do this, 
we need to send a carriage return and line feed 
so it will issue a login prompt for us. Again, we 
expect an empty string to force an uncondi- 
tional send of a carriage return (\r) followed by 
a linefeed (\n). 

Once our ISP receives the carriage return 
and line feed, it emits the login prompt "login:". 
We'll expect the phrase "gin:", and once we see 
it, we'll send our username. Then the ISP will 
prompt us for our password with the phrase 
"password:", so we'll expect "word:"; once we 
see it, we'll send our password. Now we should 
be logged in. 
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Configuring /etc/uucp/Devices 

The last file we must configure is named /etc/ 
uucp [Devices. You use this file to tell uucp which 
serial port is connected to the modem you want 
to use to establish the link. This file contains 
entries in the form 

T/pe Port Unused Speed Dialer 

In this line. Type specifies the type of connection 
you're using. Since you're connecting through a 
modem, use ACU. The For t parameter specifies 
the name of the device, without the directory 
prefix. Solaris doesn't use the Unused field, so 
just insert a hyphen (-). You specify the speed of 
your connection to the modem with the Speed 
word. Finally, with Dial er you specify the 
modem type. You must look at the file /etc/ 
uucp/Dialers for a complete list of all the legal 
Dialers. 

At our site, we're using a Hayes-compatible 
modem on port /dev/ciia/b with a connection 
speed of 38400 bps, so our entry is 

ACU cua/b - 38400 hayes 

Please note that the speed of the connection to 
the modem is independent of the modem's 
baud rate. Your computer communicates to the 
modem over a serial cable at one speed, the 
speed as specified by Speed. The modem talks 
to the modem on the other end of the phone 
line at another speed, the connection speed. For 
example, a 14.4Kbps modem sends 14,400 bits 
per second over the phone lines. In this case, 
you might choose a connection speed of 
19,200Bps. 

If the modem uses compression, it may 
actually send data over the line at an effectively 
higher rate, perhaps 20Kbps. In order to 
accommodate this higher rate, you'll want to 
select a faster connection speed. In general, it's 
best to choose the highest connection speed the 
modem supports. 

Configuring /etc/gateways 

If your system has another network interface 
on it (as most do), then it will act as a router 
when connected to the Internet. However, you 
don't want your machine to continually ex- 
change routing information with your ISP. If it 
does, then you'll waste bandwidth over your 



PPF channel (as well as CPU time) for the 
routing information. 

If you plan to use the dial-on-demand 
configuration, then you'll encounter yet 
another problem: Routers tend to exchange 
information frequently enough to keep your 
link active, even when no one's using it. So 
once the link activates, it will stay active even 
if no one's using it. To prevent this situation, 
add the line 

norip ipdptpO 

in the file /etc/gateways. If the file doesn't exist, 
then create it and put this line in it. 

Testing your connection 

Now that you've set up your PPP link, you're 
ready to test it to see if it works. First, start 
aspppd, the PPP daemon. To do so, you can use 
the command 

# /etc/init.d/asppp start 

This command starts the aspppd daemon, 
which manages your PPP link. If it sees a valid 
configuration, it configures the PPP interface 
(ipdptpO) and enters it into the routing table. 
You can examine the port configuration and 
routing table to see if the basic configuration is 
correct. Figure C shows how to do this — the 
i f con f i g command displays the setup for 
ipdptpO, if it exists. If the command didn't 
work, you'd see a "no such interface" error. 

We can use the ne t s t a t command to see 
whether the interface was properly registered 
into the router table. Here, you're looking for a 
default route to the ipdptpO, as shown in the 
last line in Figure C. 



Figure C 





g|||||||||||||||||U>lal--on-deniand connections with ^S^S^ttllttKKtKKKSBB 






# ifconfig ipdptpO 








~ - ■ — f 






ipdptpO; flags=Sd1< 


UP, POINTOPOINT, RUNNING, NOARP, MULTICAST) 


metric 1 mtu 8232 ' 






inet 19 8,70 


. 1 47 . 210 ~> 0.0.0 


0 netmask 


ffffffoo 








ether 0;0;0 


;0;0;0 












# netstat -rn 














Routing Table: 














Destination 


Gateway 


Flags 


Ref Use 


Interface 






1 27 .0.0. 1 


127.0.0.1 


UH 


0 


22 loO 






1 9 S . 70 . 1 47 . 0 


198.70.1 47.45 


U 


3 


0 el xO 






224.0.0.0 


198.70. 1 47 . 45 


U 


3 


0 elxo 






def aul t 


198.70. 1 47 . 210 


u 


2 


0 ipdptpO 






# 1 













You can use the ifconfig and netstat commands to ctieck wtiettier your 
configuration is reasonable. 
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If your configuration looks valid, it's time 
to test your phone number and uucp chat script. 
To start the cormection, just p i ng an address 
outside of your network. Since the default route 
goes to ipdptpO, the aspppd daemon will bring 
up the PPP link for you to try to route the 
packet. 

Please note that establishing the cormection 
may take a long time, as far as your software is 
concerned, so the first access to the Internet 
may fail. For example, in our test setup, we're 
using the ping command to bring up the link; it 
times out in about 20 seconds with a "no 
answer" error. The connection takes about 40 
seconds to establish. If we wait a little while 
and try the command again, it succeeds, as 
shown in Figure D. Now you can terminate the 
cormection using the command 

# /etc/init.d/asppp stop 

At this point, you're ready to move on to 
the next step. If you're going to use a dial-on- 
demand configuration with a static IP address, 
proceed to the next section. For a manually 
controlled cormection with dynamic IP ad- 
dresses, skip to the Manual Connections 
section. 

Using a dial-on-demand witii a 
Static iP address 

The easiest way to use the Internet is with a 
static IP address. The main advantage is that 
you needn't do anything special to make and 
break the connection. All you really need is a 
couple of minor configuration changes. Then, 
whenever you attempt to access something 
that's not local to your network, aspppd will 
establish the PPP connection with your ISP. 
After a (configurable) period of inactivity, 
aspppd automatically breaks the link. 

One disadvantage to using a static IP 
address is that most ISPs will charge you more 
money for such an address. Remember, the 

Figure D 
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j# p-ing 192.9,9 


100 






jno answer from 


192.9.9.100 






p p-ing 192.9.9 


100 






1192 ,9 .9 . 100 -is 


al ive 














r 









Be patient when starting the link, since it must diai the 
phone, buiid the PPP connection, establish routes, etc. 



provider can't allow others to use the address 
when you're not connected. 

In order to configure the PPP facility to use 
a static IP address, make two changes to the 
/etc/asppp.cfhle. First, specify the IP address 
your ISP gives you in the i f conf i g statement. 
Then, add the following statement to your path 
(just add this line after the line that specifies the 
peer_system_name) : 

inactivity_timeout 300 

This line tells aspppd to disconnect the PPP link 
after 300 seconds (five minutes) of inactivity. 
You can change the timeout length to anything 
you prefer. 

Now you're ready to use your PPP link. 
Whenever you attempt to access an address 
that's outside your network, aspppd will start 
the PPP link, if required. After the link remains 
idle for a long enough time, the link will stop. 
You needn't think any more about it. 

Manuai connections 

If you don't want to spend the extra monthly 
cost for a static IP address, then you must use 
dynamic IP addressing. In this scheme, the ISP 
can save money because it provides you with 
an IP address from a shared pool each time you 
log in. Since everyone shares this pool of IP 
addresses, the ISP needs fewer lines than would 
otherwise be required. However, this shared 
pool mandates that we configure our machine 
slightly differently. It also forces us to manually 
start and stop the link. 

In order to accommodate dynamic IP 
addresses, you must add the following line to 
the path in your /etc/asppp.cf file. This line tells 
aspppd that it should accept whatever IP ad- 
dress the ISP offers: 

negotiate_address on 

We don't try to use dial-on-demand on a 
dynamically allocated IP address because the 
routing table changes after the connection 
starts. Thus, we can't establish the correct 
default route for the PPP interface. Even if we 
could, an application that opens a persistent 
connection may fail since the IP address may be 
different on each login. (The PPP cormection 
could terminate and later restart because the 
connection might open with a different IP 
address.) 



Therefore, we must rely on manual connec- 
tion control instead. Since we're not specifying 
the inactivity_timeout parameter, the aspppd 
daemon starts the link whenever it starts and 
tries to keep the link active. When you install 
the SUNWapppr package, it installs the script 
asppp in the /etc/init.d directory. Thus, you can 
start the link with this command: 

# /etc/lnit.d/asppp start 

Similarly, you can terminate the link with the 
following command: 

# /etc/init.d/asppp stop 

The installation procedure also creates links 
to the asppp script as /etc/rc0.d/K47asppp, /etc/ 
rcl.d/K47asppp, and /etc/rc2.d/S47asppp. Because 
you always want to shut down the link when 
you're stopping the system, you'll probably 
want to leave the first two links alone. How- 
ever, the third symbolic link tells Solaris to start 
the aspppd daemon when it boots into multiuser 
mode. Since you may not want to start the PPP 
link every time you boot your computer, you 
can disable /etc/rcl.d/Si? asppp. 

Quick Tip: When you want to disable a script 
in the /etc/rc?.d directories, just rename it to 
something that doesn't start with an S or a K. 
(We t5rpically just add the prefix _DIS to 
segregate disabled files near the front of the 
directory as we described in "Taking Advan- 
tage of the Directory Sort Order.") In these 
directories, any script beginning with an S is 
automatically started, and any script starting 
with a K is automatically stopped when the 
system goes to the appropriate run level. 

Keeping the link aiive 

One disadvantage of using dynamic IP ad- 
dresses on your PPP link is that when your 
PPP link drops unexpectedly (such as when the 
link is inactive too long), an application won't 
know that the link has died. Then when aspppd 
restarts the link, chances are good that you'll 
have a different IP address. If the application is 
working under the assumption that the link 
will have the same IP address and attempts to 
communicate with the remote computer, it will 
probably fail. An example of this situation 
occurs when you're transferring a file. If the 



connection drops and comes back, the file 
transfer will hang. 

Miscelianeous notes 

When you're first configuring or otherwise 
experimenting with your PPP configuration, 
you should turn on the debugging log so you 
can see what the PPP connection is doing. The 
debugging log shows you what the link is 
doing, making it easier to track down any 
problems you may experience. 

Table A: Seven levels of debugging information 



With the debugging log enabled, the aspppd 
daemon writes debugging information to the 
log file /etc/log/asppp.log. You can select from 
among seven levels of debugging information, 
as shown in Table A. You turn on the debug- 
ging log by adding the following statement to 
the path in your /etc/asppp.cfhle, where x is the 
level of debugging information you want: 

debug_level x 

Be sure to remove this line from the path when 
you're finished debugging, as this file can grow 
extremely quickly — especially at level 9. 

Conclusion 

If you occasionally need to connect your network 
to the Internet, but don't want to pay for a 
dedicated line, then a dial-on-demand PPP link 
with a static IP address is probably your best 
solution. For cost-conscious businesses, using a 
d5mamically allocated IP address is definitely 
the cheapest way to go. Either way, with just a 
little work, you can create a part-time link to 
the Internet for your company. ❖ 



Level 


Meaning 


0 


Only log errors 


1 


Minimal connection information 


4 


Abbreviated uucp chat-script 
messages 


5 


Complete uucp chat-script messages 


7 


All uucp messages 


8 Log PPP message tracing 


9 


Log the complete IP packets 
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UTILITIES 




Using vl to reverse a 



Every once in a while you may need to 
reverse the order of lines in a file. For in- 
stance, you may be searching for data 
with a f i nd and grep pipeline that you put 
through sort and into a file, only to discover 
that you should have added the -r flag to the 
sort coirunand. Or you may have created a 
script to rename a set of files, changing /z7eOO 
through /z7e99 to fileOl through /zfclOO, only to 
realize just in time that you have the commands 
in the wrong order and could have ended up 
with one file that had been renamed 100 times, 
clobbering 99 others on the way. Unfortunately, 
there's no reverse utility that will quickly fix the 
problem. 

Here's a simple trick with v i that will let 
you reverse the order of lines in a file. It also 
illustrates one of the important details of v 1 's 
global search syntax. 

To reverse a file within v i , simply type 

:g/"/m0 

In "spoken-v i ," you might read the command 
as "Globally search for the beginning of each 
line, and for each line found, move it to imme- 
diately follow line 0." The seemingly similar 
command 

:1,$m0 

won't do what you want because it treats the 
entire block of lines as a single unit. 

The first command works the way it does 
because a global search is actually a two-step 
process. First, v i searches the file for the pattern 
and marks each matching line. Second, v i steps 
through each marked line in turn, begirming at 
the top of the file, and applies the command to 
each marked line. 



In this case, every line is marked because 
even empty lines will be matched by the /^/ 
pattern. Then, for each line, the command moves 
the current line (.) to line 0. When line 1 moves, 
it'll be in the same place it started. When line 2 
moves, it will be above line 1. Line 3 will move 
up one line, and so on. You have reversed the 
lines in a file with fewer than 10 keystrokes. 

Because the same global command we used 
above in v i will also work in ed, you can put 
the command into a reverse script, as shown in 
Figure A. 



Figure A 




#l/bin/sh — 




# 




# reverse - pri 


nt fo stdout all lines 


# in 


reverse order 


# 




PATH=/bin:/usr/ 


bin 


case $# in 




1) ed - "$ 


1" « "EOF" 


g/"/m0 




1,tp 




EOF 




*) echo Us 


age: $0 file >&2 


exi t 1 




esac 





This script uses ed to reverse the order of lines in a file. 

This command, like the v i example above, will 
reverse only a file that meets the limitation of 
V i 's and ed's maximum file size. ❖ 
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